home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / FILER / CLICBACK.ZIP / ClicBack / !ClicBack² / !Restore / !Help < prev    next >
Text File  |  1995-09-28  |  12KB  |  274 lines
  1. Please note that this application is NOT Public Domain, it is 
  2.  
  3.  
  4.           CCCCC   AAAA   RRRRR   EEEEEE  WW   WW  AAAA   RRRRR   EEEEEE
  5.         CC       AA  AA  RR  RR  EE      WW   WW AA  AA  RR  RR  EE
  6.         CC       AA  AA  RR  RR  EE      WW W WW AA  AA  RR  RR  EE
  7.         CC       AAAAAA  RRRRR   EEEEE   WW W WW AAAAAA  RRRRR   EEEEE
  8.         CC       AA  AA  RR RR   EE      WWWWWWW AA  AA  RR RR   EE
  9.         CC       AA  AA  RR  RR  EE      WWW WWW AA  AA  RR  RR  EE
  10.           CCCCC  AA  AA  RR  RR  EEEEEE  WW   WW AA  AA  RR  RR  EEEEEE
  11.  
  12. It is NOT free software.
  13.  
  14. You may pass on copies of this Demonstration Copy to your friends 
  15. providing that it is distributed complete with this documentation file, 
  16. and with the copyright message intact.
  17.  
  18.                                !ClicBack
  19.                        Hard Disk Backup Utilities
  20.                              Version 2.8
  21.                             © Steve Spry 1995.
  22.  
  23. !ClicBack Utilities are CAREWARE and NOT PUBLIC DOMAIN. 
  24. This means that 100% of the proceeds are given to charity.In the 
  25. case of these programs the charity is CLIC,The Cancer & Leukaemia
  26. In Childhood Trust, registered charity number 802396.
  27. If, after a period of two weeks, you find the program useful you are 
  28. required to register your copy of the programs for a fee of £10.  This 
  29. payment will entitle you to the "Key" file which will remove the banner 
  30. file and put your name into the Info box. As a registered user you will
  31. also be entitled to free technical support.
  32. To register your copy of the programs please send a cheque or postal 
  33. orders made payable to Steve Spry and a blank formatted disk to:
  34.  
  35.                   Steve Spry
  36.                   36 Moreton Avenue
  37.                   Bideford
  38.                   North Devon
  39.                   EX39 3AY
  40.  
  41. If you could also inform me as to which version of RISCOS you 
  42. have, the amount of memory you have, the processor and the size of 
  43. your hard disk it would help me to develop the program further.
  44.  
  45.  
  46. Background
  47. ~~~~~~~~~~
  48. This program had been sitting on my hard disk for nearly three years 
  49. in a half finished state whilst I played around with data compression 
  50. techniques. 
  51. Following the death of my five year old son from a brain tumour in 
  52. January 1993 I decided to finish this program and donate the proceeds 
  53. to CLIC.  As the program progressed more and more features were 
  54. added or changed. Even now there are things that I would like to 
  55. change but I could carry on for ever.
  56.  
  57. This program is dedicated to his memory and all those brave young 
  58. children fighting all forms of cancer.For there sake, if you like the 
  59. program, please register your copy of the program.
  60.  
  61. Further details about CLIC can be obtained from:
  62.  
  63.                   12-13 King Square,
  64.                   Bristol,
  65.                   BS2 8JH
  66.                   Tel: 0117 9248844
  67.                   Fax: 0117 9244505  
  68.  
  69.  
  70. Introduction
  71. ~~~~~~~~~~~~
  72. The main features of the programs include :
  73. • Full, Differential and Incremental backups.
  74. • Selective option to preserve history integrity
  75. • Backup to floppies or another hard disk.
  76. • Backup only specified directories or files.
  77. • Exclude any files or directories from the backup.
  78. • Verify whilst backing up.
  79. • Password protection for added security.
  80. • 32 bit CRC
  81. • Restore data to any directory.
  82. • Powerful searching facility to locate Files / Directories or
  83.   Applications within backup data.
  84. • Ability to restore whole directories or applications.
  85. • Variable data compression.
  86. • Estimate number of floppy disks required.
  87. • Estimate time required to complete backup.
  88. • Time taken so far.
  89. • Save settings as configuration files.
  90. • Customisation file.
  91. • Acorn’s Interactive help supported.
  92.  
  93.  
  94.  
  95.                                 Restore
  96.                                 ~~~~~~~
  97. !Restore is copied to the first disc in a full backup.  If you are using a
  98. Differential or Incremental backup then it is assumed that it will form
  99. part of a full backup set and that a copy of !Restore would have been copied 
  100. to the first disc in the full backup set.  This is done to save disc space
  101. on Incremental or Differential backups.
  102.  
  103. Double clicking on the !Restore icon will load the application onto the iconbar. 
  104. Clicking on the icon will open the programs main window.
  105.  
  106.  
  107.                                <Figure 6>
  108.  
  109. The File Source and Destination icons will contain the default paths 
  110. for the restore.These are obtained from a header within the BackData 
  111. file.The destination will be the same as the source for the original 
  112. backup.
  113.  
  114. If you wish to restore the data to a different directory or drive then 
  115. either drag the destination directory (or a file from that directory) into 
  116. the destination icon or press menu over the window and drag the save 
  117. icon from the destination submenu to your selected directory.
  118.  
  119. Main Window Menu
  120. ~~~~~~~~~~~~~~~~ 
  121. The menu has the following options.
  122.  
  123. Info
  124. Info will display information about your version of the program. The 
  125. Registered to field will show ***Unregistered *** or your name.
  126.  
  127. Source
  128. The program expects to find the backup data file in the same 
  129. directory as the !Restore program. If the program can not find the 
  130. backup data an error will be displayed.
  131.  
  132. When the program starts it will read certain details about the backup 
  133. from the backup data such as source and destination.
  134.  
  135. Destination
  136. This will bring up a standard save as box. Dragging the file icon to 
  137. the destination directory will insert the full path into the destination 
  138. icon.You can also select the destination directory by dropping the 
  139. selected directory onto the destination icon. This will also insert the full 
  140. path into the destination icon.If you drop a file onto the destination icon 
  141. the parent directory will be inserted into the icon.
  142.  
  143. Password
  144. This menu option leads to a writable icon into which you will have 
  145. to enter the password if the backup is password protected. The 
  146. Password is also CASE SENSITIVE i.e. KEY is not the same password 
  147. as Key.  If the backup has been password protected but you do not enter 
  148. a password before starting the restore the program will prompt you for 
  149. a password before the restoration of data starts, but has no means of 
  150. checking that the password is correct.
  151.  
  152. Clicking on OK will start the restore process.  The program will 
  153. display the status window which is identical to !ClicBack's status 
  154. window.
  155.  
  156. !ClicBack now supports filenames of upto 56 characters in length as used
  157. by Jason Tribbeck's !Longfiles.  Because !Longfiles is basically an extension
  158. of the operating system you will need to ensure that !Longfiles has been installed
  159. prior to restoring your data. 
  160.  
  161.  
  162. History
  163.  
  164. 1.00
  165. Not so much of a hard disk backup program but a hard disk cleaner. 
  166. Managed to wipe every other file on a hard disk. If it wasn’t for a bug I 
  167. would have had the lot. sorry Buck!
  168.  
  169. 2.01
  170. A working Multi-tasking backup program which I was reluctant do 
  171. release into the world incase there where any bugs that I had not found 
  172. despite extensive testing.Finally plucked up the courage to release it 
  173. and was pleased by the stability of the program.
  174.  
  175. 2.06
  176. Fixed the minor bugs that have been reported and made some 
  177. improvements that have been suggested by users e.g. Pause, better 
  178. compression ratio etc.
  179.  
  180. 2.50
  181. Implemented the Difference Algorithm instead of using just  the date 
  182. time stamp.  Fixed a bug that prevented !ClicBack from formatting 
  183. high density disks (couldn’t test this on my old A3000).  Added the 
  184. compression level to the options file.  Sorted out !Restore to only close 
  185. the destination window.  Fully tested on the RiscPC.
  186.  
  187. 2.51
  188. Fixed a bug that missed the last character off the filename when 
  189. using !Retrieve.
  190.  
  191. 2.52
  192. Added detection of native RISCOS format disks. !ClicBack will now 
  193. only accept D/E or F formatted disks.
  194.  
  195. 2.53
  196. Fixed a bug that prevented !Retrieve restoring any single file that 
  197. was split across two or more disks.
  198.  
  199. 2.54
  200. Removed “Unstamped” option as it has been made redundant since 
  201. the release of version 2.50. Also fixed a bug that would cause 
  202. !ClicBack to crash if there were no files to backup.
  203.  
  204. 2.60
  205. Removed all restrictions on the demonstration version of the 
  206. programs and decided to use a key file for registered users. (Thank you 
  207. David Holden).  Included and Shift-Drag option for excluding files to 
  208. exclude all object with a given leafname.  Finally tracked down the
  209. problem with !Restore asking for a disk beyond the last disk in the
  210. backup set.
  211.  
  212. 2.70
  213. Following several phone calls from David Holden I have changed a number
  214. of things in this version and fixed a problem with ArcFS and SparkFS which
  215. would cause !ClicBack to crash when ArcFS or SparkFS ran out of memory.
  216. The problem was caused by the above two programs intercepting calls to
  217. OS_GBPB and OS_File and changing the object type returned from these calls
  218. from 3 (Image files) to 2 (directory).  !ClicBack therefore thought that
  219. it was recursing through a directory structure and wasn't expecting another
  220. program to deny access to a file because it was out of memory.  Anyway it's
  221. fixed now.  Also changed the following:
  222.   1.  User interface - I think this gives a cleaner, less cluttered feel
  223.       to the program.  I know the popup menus do not appear in quite the
  224.       right positions but I cannot find a way around in in Risc_OSLib.
  225.   2.  Changed format of configuration files.  These are now in a human-readable
  226.       format, the syntax of which can be found elsewhere in this manual.
  227.   3.  Added a means for the user to specify which files not to compress.  This
  228.       can make backing up data a lot quicker as the program no longer has to
  229.       work so hard in order to same a few k's compressing pre-compressed files.
  230.   4.  Re-coded a large portion of the programs, saving quite a bit of space
  231.       and, hopefully making it a bit quicker.
  232.   5.  !ClicBack now recognises image files and will back them up as a
  233.       single (sometimes large) file (DOS partition files).
  234.   6.  Cleared the bug that would cause the program to sometimes crash when
  235.       you selected History.  I still don't know why it did it but i've
  236.       recoded this and the problem (appears) to have vanished.  The
  237.       text justification of the history file does appear a bit strange on
  238.       a RiscPC if you are using an outline font for the desktop.
  239. 2.71
  240. Fixed a problem with the lists that would cause the program to crash if
  241. the user selected all items and then selected remove.
  242. Also changed the saving of options files to save the numerical filetype
  243. and not the string filetype as this could cause problems if the textual
  244. filetype was not know to the system when the options file was loaded.
  245.  
  246. Future Plans
  247. I intend to make the restore program more visually based. i.e. show a 
  248. directory tree and allow you to point and click to specify the files to 
  249. restore.  As usual the problem is time.
  250.  
  251. Improve the search facilities to incorporate fuzzy matching. i.e. a 
  252. search for directtory would find directory.
  253.  
  254. And the normal improvement ..... speed. I hope to double the 
  255. program speed of the backup eventually. The speed of restoration is 
  256. already pretty impressive for large files.
  257.  
  258. known bugs
  259. None at the moment.... and as they say, it's not a bug it's just an undocumented
  260. feature!!!!
  261.  
  262. Thanks To
  263. Dominic Symes for THE text(?) editor !ZAP. If you haven’t got a 
  264. copy get one!
  265. Martin Ebourne and Bryan Scattergood for the C/Assembler modes in !ZAP.
  266. Acorn for there C Compiler (and computer).
  267. Jonathan Marten for the inspiration to start this program. (UAP ?)
  268. Chris Taylor for the suggestions on improving the program and encouragement
  269. My wife for being a computer widow.
  270. David Holden for persuading me to remove all restrictions on the program and
  271. for his advice and suggestions regarding !ClicBack's operation.
  272. And all registered users of the program. 
  273.  
  274.